(dabbrev--select-buffers): Add a doc string.

diff --git a/lisp/dabbrev.el b/lisp/dabbrev.el
index a5a37c3d20f1c972ed3c91dfd4f29963e800e8ca..62c3befa90830faf83944e3fb496cafd23cae6c1 100644 (file)
--- a/lisp/dabbrev.el
+++ b/lisp/dabbrev.el
@@ -651,6 +651,11 @@ See also `dabbrev-abbrev-char-regexp' and \\[dabbrev-completion]."
 ;;; Find all buffers that are considered "friends" according to the
 ;;; function pointed out by dabbrev-friend-buffer-function.
 (defun dabbrev--select-buffers ()
+  "Return a list of all buffers that should be searched for a possible abbrev.
+
+This function makes a list of all the buffers returned by `buffer-list', and
+then filters out every buffer for which `dabbrev-friend-buffer-function',
+if it is bound, returns nil.  The resulting partial list is returned."
   (save-excursion
     (and (window-minibuffer-p (selected-window))
         (set-buffer (dabbrev--minibuffer-origin)))